
    ADD EVENTS TEST

    This window contains the following fields:

    Hostnames

    You can use this field to specify which host(s) will be configured
    for this test. Leave a blank space between host names for multiple
    entries. You can also click on the arrow button to the right to pop
    up a pick list of all hosts within the current pool and make your
    selection(s) from there.

    Testname

    Use this field to specify the name for your test. This must be the
    full pathname of the file (directory) or process you want to monitor

    Units of measure

    This view-only field shows what the standard units of measure are
    for this test.

    Sub-command

    This view-only field shows the Events-defined subcommand, if any,
    this test will use during its execution.

    Internal Test

    This view-only field shows whether this test is an Events built-in
    test (Yes) or a user-defined test (No).

    Test Group

    This view-only field shows the test group type for this test.

    State

    Use this toggle to turn the test On or Off (the default).

    Severity

    Use this toggle to specify what level of severity to assign this
    test from the following message types:

    + OK
    + Informational (the default)
    + Warning
    + Error
    + Severe

    Use PEP

    Use this toggle to specify whether this test should use PEP to
    report its results or filter any action to be taken. The default is
    Yes.

    Logging

    Use this toggle to specify whether logging should be enabled for
    this test. The default is Yes.

    Delta

    If you enabled Logging, you can use this field to establish a
    "changed by" (delta) value. Enlighten will record the most recent
    value measured by the test if that value differs by at least this
    delta amount from the previously logged value.

    See the "Events" chapter in the ENighten User Guide for more
    details.

    Mailer

    You can use this field to specify which mail program should be used
    to deliver any alarms to the User. The default is /bin/mail. If you
    use another mail program, it must use the same syntax as the
    standard UNIX mail program.

    User

    You can use this field to specify the user(s) who should receive any
    alarm information. The default is root. Leave a blank space between
    each user name for multiple entries. If you set this value to
    nobody, no mail will be sent.

    Use the Command field if you want to enter a process.

    Command

    You can use this field to specify any executable this test should
    run when it sets an alarm. This can be a script or a compiled
    executable.

    Age

    This field can specify a threshold for when a file is considered to
    have "aged" in a directory. This value is only available if this
    test will monitor a queue.

    You can use this field to select (in minutes) what the "aged"
    threshold is. Only files more than 'age' minutes old are counted as
    'old'.


    Test Freq

    Use this field to specify how often to run this test. The default is
    every 5 minutes.

    Alarm Freq

    Use this field to specify how long to wait before sending another
    new alarm about this test. The default is every hour.

    High Thresh

    You can use this field to specify an absolute high level alarm set
    point for the data you're measuring in this test. This can be an
    integer or floating-point value.

    Low Thresh

    You can use this field to specify an absolute low level alarm set
    point for the data you're measuring in this test. This can be an
    integer or floating-point value.

    Pos Rate

    You can use this field to specify a positive percentage change alarm
    set point for the data you're measuring in this test. This threshold
    compares the current test value with the last measured value (check
    for percentage of change since last tested). This must be a
    floating-point value.

    Neg Rate

    You can use this field to specify a negative percentage change alarm
    set point for the data you're measuring in this test. This threshold
    compares the current test value with the last measured value (check
    for percentage of change since last tested). This must be a
    floating-point value.

    Pos Jump

    You can use this field to specify a positive incremental change
    alarm set point for the data you're measuring in this test. This
    threshold compares the current test value with the last measured
    value (check for change of X points since last tested). This can be
    an integer or floating-point value.

    Neg Jump

    You can use this field to specify a negative incremental change
    alarm set point for the data you're measuring in this test. This
    threshold compares the current test value with the last measured
    value (check for change of X points since last tested). This can be
    an integer or floating-point value.

    API File

    If you're creating an API test, use this field to specify the full
    pathname of the file which will hold the results of your test.

    See the "EVENTS" chapter in the ENighten User Guide for examples and
    more details on creating API tests.

    API Data

    If you're creating an API test, use this field to specify which
    field or column holds the data value to monitor. Use a digit
    prefaced by an `f' for a field number or a `c' for a column number.
    The default assumes this value is a field number. If you're using a
    column designator, each character in any input file line/row is
    handled as one column.

    API Label

    If you're creating an API test, you can use this field to specify
    which field in your file contains a descriptive word or label.

    Logfile Clamping Regular Expressions

    You can use regular expressions to define "types" of messages based
    upon pattern matching. When one or more of these message types are
    found in a file, an alarm is sent to whatever agents you specify in
    your test. Each time this test is run, it will only evaluate those
    file entries which were added since the last occurrence of this
    test.

    For more information on regular expressions, see your on-line O/S
    manual, section regx(3) (typically this is located in
    /usr/man/man3).

    Buttons

    This window contains the following buttons:


    Apply

    Click on this button to add the test configuration defined in the
    window to the testtab files for all specified hosts.

    Note: Enlighten will be updated immediately, but the testtab file
    will not be updated for another two minutes.

    Set Defaults

    Click on this button to set default values in the text fields based
    on the test type category you previously specified in the Select New
    Event Type window.

    Close

    Click on this button to discard any changes and close the window.

